Skip to content

Conversation

@bparrish17
Copy link
Contributor

@bparrish17 bparrish17 commented Dec 17, 2025

Overview

TL;DR: The pull command runs the relevant formatter for each output.

The existing JSON format remains unchanged, it pulls from GET /v2/textItems and GET /v2/components and then iterates over each returned value to get configured variants.

For the new formats we had to get all the data directly from the API. This lead to the creation of the BaseExport formatter class. This iterates over the configured projects/component folders/variants etc. to then fetch the relevant files and write them to the configured directory.

What to Review

  • Check out the BaseExport formatter and how it fits with the pull command. Does it make sense? Does it account for possible future features?
  • Check out the individual formatters extending BaseExport
  • Test with your own projects/files by running the steps below. Do the outputs appear as you would expect given your config/environment?

Questions to Answer

  • Do you have any concerns with updating the existing JSON format to use the new BaseExport formatter style instead of the current one defined in JSONFormatter?
  • Are there any future features or other items you worry this new structure may not account for?
  • Are there potential customer configurations you think may need to be accounted for that aren't already being considered?
  • Do the relevant API Additions account for future needs? e.g. variant status filtering

Test Plan/Setup

Setup:

  1. Make sure you have a .env with the following content:
DEBUG=true
DITTO_API_HOST=http://localhost:3001
  1. Get a robust sample config setup that let's you check out the different formats, for example
projects:
  - id: <project-A>
  - id: <project-B>
variants:
  - id: base
  - id: spanish
  - id: japanese
components:
  folders:
    - id: root
outputs:
  - format: json
     framework: i18next
     outDir: "./ditto/json
     
  - format: android
    outDir: "./ditto/android"

  - format: ios-strings
    outDir: "./ditto//ios-strings"

  - format: ios-stringsdict
    outDir: "./ditto/ios-stringsdict"

Run yarn sync at the root of the CLI directory, this should pull from your local Ditto environment

* Add scaffolding for ios-strings support, notably IOSStringsFormatter class, and IOSStringsOutput file

* Add /v2/variants endpoint. Update IOSStringsFormatter to pull down variants and projects as expected. Moved shared BaseFormatter class methods out of JSON and IOSStringsFormatters

* Minor inline doc updates

* Add pull command E2E tests for outputted ios-strings files. Added component mapping to iosStringsFormatter

* Add unit tests to IOSSTringsFormatter class

* Update variant fetching to be shared across textItems and components. Unit tests additions to IOSStringsFormatter class

* Update http request tests to handle default error

* Minor: test fix

* Minor: cleanup and .gitignore of local items
…at additions (#130)

* Add ios-stringsdict support to BaseFormatter

* Refactor IOSStringsFileFormatter into BaseExportFormatter to be shared amongst all export formats. Updated IOSStringsDict to use that class

* Add android export format

* Add BaseExportFormatter class tests. Updated IOSStringsFormatter tests to no longer include baseExport method tests. Updated all formats to test for correct output file creation

* Update base generateQueryParams to take in filters as sole param

* Add i18n test cases

* Add ios-stringsdict and Android XML formatting tests to pull

* Add ICU format. Update HTTP Response types to allow for JSON. Added generics to BaseFormatter to allow for parameter-ized response types

* Updated ExportComponentsResponse and TextItemsResponse Zod schema

* Made BaseExportFormatter abstract class

* Minor: clean

* Test fix and HTTP wrapper cleanup

* Minor: clean

* Add promise.all to fetchTextItemsMap and fetchComponentsMap for performance
* Add iosLocale to config and file generation

* Add new fetch request for swift file from API

* Add Swift file generation logic to baseexport class

* clean for PR

* Add test cases to ios methods on baseExport class

* Minor: clean

* minor: remove unused type

* minor: remove test script

* update pull params for export endpoints

* Update all instances of 'icu' to be 'json_icu'

* Address initial PR comments

* Add swift file generation to root of pull command. Address some cleanup review comments

* Fix pull command tests for iosLocales

* Move generateSwiftFile tests to util file

* Minor clean

* Remove console log and fix test data

* Add test case for empty iosLocalese array

* Minor name clarification

* Fix format default case, missing promise.all, and typing issue

* Added ios-specific getLocalesPath method to those classes, along with tests

* Fix issue where ___<variant_id> suffixed files were getting written to iosLocale directories
…c directory. Removed now-unnecessary type params from Formatter classes
@bparrish17 bparrish17 marked this pull request as ready for review January 7, 2026 19:07
@bparrish17 bparrish17 merged commit 7709c56 into master Jan 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants